home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / ab20 / aplictns / analyplt.doc < prev    next >
Text File  |  1991-10-08  |  3KB  |  55 lines
  1. AnalyRIM's PLOT function
  2.  
  3. AnalyRIM has a primitive designed to allow it to cooperate with a plotting
  4. program such as GnuPLOT to plot data from the spreadsheet on whatever
  5. output devices the plot program handles (which for GnuPLOT are many!).
  6. This is handled by a command PL which plots one or two ranges (depending
  7. on whether you want to plot only Y coordinates or both X and Y coordinates)
  8. and a convention to allow title and the like information to be passed.
  9.  
  10. The command added is
  11.  
  12. PL v1:v2,v3:v4;systemcommand
  13.  
  14. and the action is the following:
  15.  
  16. The first range v1:v2 must be a cell range (horizontal, vertical or
  17. page) which corresponds to the X coordinates to plot if the v3:v4
  18. argument exists, or which corresponds to the Y coordinates if
  19. not. The second range, if present, must be another legal range
  20. (in any direction). Both ranges must be one dimensional and
  21. should be the same length if both are present.
  22.    AnalyRim will produce a file named "pccplt.dat" in the default
  23. directory containing the values of the cells in the one or two
  24. ranges, either one value per line (if only v1:v2 is in the 
  25. command) or two values per line (if both exist) so that the
  26. lines each contain one point to be plotted. This is the format
  27. GnuPlot (among others) want.
  28.    In addition, the contents of the FORMULAS for accumulators X,
  29. Y, and Z will be placed in a file "titleinfo.txt" also in the default
  30. directory. These may be used to pass titles, commands to format the
  31. plot, or whatever. In the case of GnuPLOT, even a "load" command may
  32. be placed here to do fancier formatting using some other predefined
  33. file. The first 80 characters of each formula are copied without
  34. further examination.
  35.    Once these files are created (and closed), AnalyRIM executes a command
  36. which is either the "systemcommand" part of the PL command, or which
  37. defaults to the command @DK:PLTFIL.PCP on VMS, to EXECUTE DK:PLTFIL.PCP
  38. on AmigaDos, and to the command /DK/PLTFIL.PCP in Unix. The system
  39. command part can be whatever syntax is desired, but will generally be a
  40. script which will run the plot program and get it to read the data (and
  41. possibly title information) and produce a plot. The plot output and
  42. format may be controlled by the input passed to the plot program.
  43.  
  44.   The reason the X, Y, and Z accumulator formulae don't have any pre-added
  45. text is to allow this text to be placed in the accumulator.
  46.  
  47.    It is expected that for actual use, a command file to AnalytiCalc
  48. will be devised to be activated by a function key, and that this file
  49. will cause title information to be placed in the X/Y/formulae and
  50. will select the range(s) to be plotted and the style of the plot.
  51.     By moving this functionality to a separate program, AnalyRIM avoids
  52. having to duplicate work already available, yet permits plotting to
  53. be done (once some setup is done) as conveniently as if the plotting
  54. code were linked in.
  55.